<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta http-equiv="Content-Language" content="zh-CN"><title>timedatectl
  中文手册 [金步国]</title><style>
@font-face { font-family: "JinBuGuoWebMono"; src: url("http://www.jinbuguo.com/d/mono.ttf") format("truetype"); }
* { font-family: "JinBuGuoWebMono", "Ubuntu Mono", "Consolas", "Menlo", monospace; }
body { margin:10px; }
h1 { text-align:center; background:#ddd; }
h2#auth_name { text-align:center; margin: 10px 5%; }

    a.headerlink {
      color: #c60f0f;
      font-size: 0.8em;
      padding: 0 4px 0 4px;
      text-decoration: none;
      visibility: hidden;
    }

    a.headerlink:hover {
      background-color: #c60f0f;
      color: white;
    }

    h1:hover > a.headerlink, h2:hover > a.headerlink, h3:hover > a.headerlink, dt:hover > a.headerlink {
      visibility: visible;
    }
</style><script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><h1>timedatectl 中文手册</h1><h2 id="auth_name">译者：<strong><a href="http://www.jinbuguo.com/">金步国</a></strong></h2><hr><h3>版权声明</h3><p>本文译者是一位开源理念的坚定支持者，所以本文虽然不是软件，但是遵照开源的精神发布。</p><ul><li>无担保：本文译者不保证译文内容准确无误，亦不承担任何由于使用此文档所导致的损失。</li><li>自由使用：任何人都可以自由的<u>阅读/链接/打印</u>此文档，无需任何附加条件。</li><li>名誉权：任何人都可以自由的<u>转载/引用/再创作</u>此文档，但必须保留译者署名并注明出处。</li></ul><h3>其他作品</h3><p>本文译者十分愿意与他人分享劳动成果，如果你对我的其他翻译作品或者技术文章有兴趣，可以在如下位置查看现有的作品集：</p><ul><li><a href="http://www.jinbuguo.com/">金步国作品集</a> [ <a href="http://www.jinbuguo.com/">http://www.jinbuguo.com/</a> ]</li></ul><h3>联系方式</h3><p>由于译者水平有限，因此不能保证译文内容准确无误。如果你发现了译文中的错误(哪怕是错别字也好)，请来信指出，任何提高译文质量的建议我都将虚心接纳。</p><ul><li>Email(QQ)：70171448在QQ邮箱</li></ul><hr><a href="systemd.index.html">手册索引</a> ·
  <a href="systemd.directives.html">指令索引</a><span style="float:right">systemd-241</span><hr><div class="refentry"><a name="timedatectl"></a><div class="titlepage"></div><div class="refnamediv"><h2>名称</h2><p>timedatectl — 控制系统的时间与日期</p></div><div class="refsynopsisdiv"><h2>大纲</h2><div class="cmdsynopsis"><p><code class="command">timedatectl [OPTIONS...]  {COMMAND}</code> </p></div></div><div class="refsect1"><a name="id-1.5"></a><h2 id="描述">描述<a class="headerlink" title="Permalink to this headline" href="timedatectl.html#%E6%8F%8F%E8%BF%B0">¶</a></h2><p><span class="command"><strong>timedatectl</strong></span> 可用于查询与修改
    系统时钟的各项设置。</p><p>可以使用
    <a href="systemd-firstboot.html#"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
    初始化
    已挂载(但未启动)的系统镜像的时区设置。</p><p><span class="command"><strong>timedatectl</strong></span> 可以显示
    <a href="systemd-timesyncd.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-timesyncd.service</span>(8)</span></a> 的当前状态。
    </p></div><div class="refsect1"><a name="id-1.6"></a><h2 id="选项">选项<a class="headerlink" title="Permalink to this headline" href="timedatectl.html#%E9%80%89%E9%A1%B9">¶</a></h2><p>能够识别的命令行选项如下：</p><div class="variablelist"><dl class="variablelist"><dt id="--no-ask-password"><span class="term"><code class="option">--no-ask-password</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#--no-ask-password">¶</a></dt><dd><p>在执行特权操作时
        不向用户索要密码。</p></dd><dt id="--adjust-system-clock"><span class="term"><code class="option">--adjust-system-clock</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#--adjust-system-clock">¶</a></dt><dd><p>当使用 <span class="command"><strong>set-local-rtc</strong></span> 命令时，
        若使用了此选项，
        则表示根据RTC时间来更新系统时钟。
        若未使用此选项，
        则表示根据系统时钟来更新RTC时间。</p></dd><dt id="--monitor"><span class="term"><code class="option">--monitor</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#--monitor">¶</a></dt><dd><p>与 <span class="command"><strong>timesync-status</strong></span> 命令一起使用，
        表示监视
        <a href="systemd-timesyncd.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-timesyncd.service</span>(8)</span></a>
        的状态并不断刷新输出。可以使用 <span class="keycap"><strong>Ctrl</strong></span>+<span class="keycap"><strong>C</strong></span> 
        终止监视。</p></dd><dt id="-a"><span class="term"><code class="option">-a</code>, </span><span class="term"><code class="option">--all</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#-a">¶</a></dt><dd><p>显示全部的
        <a href="systemd-timesyncd.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-timesyncd.service</span>(8)</span></a>
        属性，无论这些属性是否已设置。</p></dd><dt id="-p"><span class="term"><code class="option">-p</code>, </span><span class="term"><code class="option">--property=</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#-p">¶</a></dt><dd><p>仅显示指定的
        <a href="systemd-timesyncd.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-timesyncd.service</span>(8)</span></a>
        属性。若未指定任何属性则显示全部已设置的属性。
        参数必须是一个例如 "<code class="literal">ServerName</code>" 这样的属性名称。
        可以多次使用此选项，以显示多个属性。</p></dd><dt id="--value"><span class="term"><code class="option">--value</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#--value">¶</a></dt><dd><p>当使用 <span class="command"><strong>show-timesync</strong></span> 命令显示属性时，
          仅显示属性的值(不显示"<code class="literal">=</code>"与属性名称)。</p></dd><dt id="-H"><span class="term"><code class="option">-H</code>, </span><span class="term"><code class="option">--host=</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#-H">¶</a></dt><dd><p><a name="host-text"></a>操作指定的远程主机。可以仅指定一个主机名(hostname)，
      也可以使用 "<code class="literal">username@hostname</code>" 格式。
      hostname 后面还可以加上
      SSH监听端口(以冒号"<code class="literal">:</code>"分隔)与容器名(以正斜线"<code class="literal">/</code>"分隔)，
      也就是形如 "<code class="literal">hostname:port/container</code>" 的格式，
      以表示直接连接到指定主机的指定容器内。
      操作将通过SSH协议进行，以确保安全。
      可以通过
      <span class="command"><strong>machinectl -H
      <em class="replaceable"><code>HOST</code></em></strong></span> 命令列出远程主机上的所有容器名称。IPv6地址必须放在方括号([])内。</p></dd><dt id="-M"><span class="term"><code class="option">-M</code>, </span><span class="term"><code class="option">--machine=</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#-M">¶</a></dt><dd><p><a name="machine-text"></a>在本地容器内执行操作。
      必须明确指定容器的名称。</p></dd><dt id="-h"><span class="term"><code class="option">-h</code>, </span><span class="term"><code class="option">--help</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#-h">¶</a></dt><dd><p><a name="help-text"></a>显示简短的帮助信息并退出。
    </p></dd><dt id="--version"><span class="term"><code class="option">--version</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#--version">¶</a></dt><dd><p><a name="version-text"></a>显示简短的版本信息并退出。</p></dd><dt id="--no-pager"><span class="term"><code class="option">--no-pager</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#--no-pager">¶</a></dt><dd><p>不将程序的输出内容管道(pipe)给分页程序。</p></dd></dl></div></div><div class="refsect1"><a name="id-1.7"></a><h2 id="命令">命令<a class="headerlink" title="Permalink to this headline" href="timedatectl.html#%E5%91%BD%E4%BB%A4">¶</a></h2><p>能够识别的命令如下：</p><div class="variablelist"><dl class="variablelist"><dt id="status"><span class="term"><span class="command"><strong>status</strong></span></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#status">¶</a></dt><dd><p>显示系统时钟与RTC的当前状态，
        包括时区设置以及网络时间同步服务(也就是
        <code class="filename">systemd-timesyncd.service</code>)的状态。
        注意，此命令并不检查是否存在其他时间同步服务。
        如果没有使用任何命令，那么这是默认命令。
        </p></dd><dt id="show"><span class="term"><span class="command"><strong>show</strong></span></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#show">¶</a></dt><dd><p>以机器可读格式显示与 <code class="option">status</code> 一样的信息。
        此命令的输出主要供程序使用，
        而 <code class="option">status</code> 命令的输出则是人类易读的格式。</p><p>默认不输出空属性，但可以使用 <code class="option">--all</code> 选项强制输出所有属性。
        可以使用 <code class="option">--property=</code> 选项仅输出特定的属性。</p></dd><dt id="set-time [TIME]"><span class="term"><span class="command"><strong>set-time [TIME]</strong></span></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#set-time%20%5BTIME%5D">¶</a></dt><dd><p>将系统时钟设为指定的时间，
        并同时更新RTC时间。
        [TIME] 是一个形如 "2012-10-30
        18:17:16"的时间字符串。</p></dd><dt id="set-timezone [TIMEZONE]"><span class="term"><span class="command"><strong>set-timezone [TIMEZONE]</strong></span></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#set-timezone%20%5BTIMEZONE%5D">¶</a></dt><dd><p>设置系统时区，
        也就是更新 <code class="filename">/etc/localtime</code> 软连接的指向。
        可以用下面的 <span class="command"><strong>list-timezones</strong></span> 命令列出所有可用时区。
        如果RTC被设为本地时间，
        此命令还会同时更新RTC时间。
        详见
        <a href="localtime.html#"><span class="citerefentry"><span class="refentrytitle">localtime</span>(5)</span></a>
        手册。</p></dd><dt id="list-timezones"><span class="term"><span class="command"><strong>list-timezones</strong></span></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#list-timezones">¶</a></dt><dd><p>列出所有可用时区，每行一个。
        列出的值可以用作前述
        <span class="command"><strong>set-timezone</strong></span> 命令的参数。</p></dd><dt id="set-local-rtc [BOOL]"><span class="term"><span class="command"><strong>set-local-rtc [BOOL]</strong></span></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#set-local-rtc%20%5BBOOL%5D">¶</a></dt><dd><p>设为 "<code class="literal">no</code>" 表示在RTC中存储UTC时间；
        设为 "<code class="literal">yes</code>" 表示在RTC中存储本地时间。
        应该尽一切可能在RTC中存储UTC时间。
        尽量不要在RTC中存储本地时间，
        因为这会造成一系列麻烦，
        尤其是在切换时区以及调整夏令时或冬令时的时候。
        注意，
        除非明确使用了
        <code class="option">--adjust-system-clock</code> 选项，
        否则此命令还会同时用系统时钟更新RTC时间。
        此命令还会改变
        <code class="filename">/etc/adjtime</code> 文件第三行的内容，详见
        <a href="http://man7.org/linux/man-pages/man8/hwclock.8.html"><span class="citerefentry"><span class="refentrytitle">hwclock</span>(8)</span></a> 手册。
        </p></dd><dt id="set-ntp [BOOL]"><span class="term"><span class="command"><strong>set-ntp [BOOL]</strong></span></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#set-ntp%20%5BBOOL%5D">¶</a></dt><dd><p>接受一个布尔值，表示是否开启网络时间同步(若可用)。
        设为 yes 表示启用并启动 <code class="filename">systemd-timedated.service</code>
        中的环境变量 <code class="varname">$SYSTEMD_TIMEDATED_NTP_SERVICES</code> 中的第一个存在的服务。
        设为 no 表示禁用并停止环境变量
         <code class="varname">$SYSTEMD_TIMEDATED_NTP_SERVICES</code> 中的所有服务。</p></dd></dl></div><div class="refsect2"><a name="id-1.7.4"></a><h3 id="systemd-timesyncd 命令">systemd-timesyncd 命令<a class="headerlink" title="Permalink to this headline" href="timedatectl.html#systemd-timesyncd%20%E5%91%BD%E4%BB%A4">¶</a></h3><p>下面的命令专用于
      <a href="systemd-timesyncd.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-timesyncd.service</span>(8)</span></a>
      </p><div class="variablelist"><dl class="variablelist"><dt id="timesync-status"><span class="term"><span class="command"><strong>timesync-status</strong></span></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#timesync-status">¶</a></dt><dd><p>显示
          <a href="systemd-timesyncd.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-timesyncd.service</span>(8)</span></a>
          的当前状态。如果还使用了 <code class="option">--monitor</code> 选项，那么表示不断监视并刷新此服务的状态。</p></dd><dt id="show-timesync"><span class="term"><span class="command"><strong>show-timesync</strong></span></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#show-timesync">¶</a></dt><dd><p>以机器可读格式显示与 <code class="option">timesync-status</code> 一样的信息。
          此命令的输出主要供程序使用，
          而 <code class="option">timesync-status</code> 命令的输出则是人类易读的格式。</p><p>默认不输出空属性，但可以使用 <code class="option">--all</code> 选项强制输出所有属性。
        可以使用 <code class="option">--property=</code> 选项仅输出特定的属性。</p></dd></dl></div></div></div><div class="refsect1"><a name="id-1.8"></a><h2 id="退出状态">退出状态<a class="headerlink" title="Permalink to this headline" href="timedatectl.html#%E9%80%80%E5%87%BA%E7%8A%B6%E6%80%81">¶</a></h2><p>返回值为 0 表示成功，
    非零返回值表示失败代码。</p></div><div class="refsect1"><a name="id-1.9"></a><h2 id="环境变量">环境变量<a class="headerlink" title="Permalink to this headline" href="timedatectl.html#%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F">¶</a></h2><div class="variablelist"><dl class="variablelist"><dt id="$SYSTEMD_PAGER"><span class="term"><code class="varname">$SYSTEMD_PAGER</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#%24SYSTEMD_PAGER">¶</a></dt><dd><p>指定分页程序。仅在未指定 <code class="option">--no-pager</code> 选项时有意义。
      此变量会覆盖 <code class="varname">$PAGER</code> 的值。如果 <code class="varname">$SYSTEMD_PAGER</code> 与 <code class="varname">$PAGER</code> 都未设置，
      那么将会依次尝试如下常见的分页程序：
      <a href="http://man7.org/linux/man-pages/man1/less.1.html"><span class="citerefentry"><span class="refentrytitle">less</span>(1)</span></a>,
      <a href="http://man7.org/linux/man-pages/man1/more.1.html"><span class="citerefentry"><span class="refentrytitle">more</span>(1)</span></a>,
      如果最终仍未找到分页程序，那么将不使用分页。
      将此变量设为空字符串或 "<code class="literal">cat</code>" 等价于使用 <code class="option">--no-pager</code> 选项。</p></dd><dt id="$SYSTEMD_LESS"><span class="term"><code class="varname">$SYSTEMD_LESS</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#%24SYSTEMD_LESS">¶</a></dt><dd><p>用于覆盖默认传递给 <span class="command"><strong>less</strong></span>
      程序的命令行选项("<code class="literal">FRSXMK</code>")。</p><p>如果 <code class="varname">$SYSTEMD_LESS</code> 的值不含 "<code class="literal">K</code>" ，
      并且使用 <span class="command"><strong>less</strong></span> 作为分页程序，那么
      <span class="keycap"><strong>Ctrl</strong></span>+<span class="keycap"><strong>C</strong></span> 信号将会被忽略。
      这将允许 <span class="command"><strong>less</strong></span> 自己处理
      <span class="keycap"><strong>Ctrl</strong></span>+<span class="keycap"><strong>C</strong></span> 信号。</p></dd><dt id="$SYSTEMD_LESSCHARSET"><span class="term"><code class="varname">$SYSTEMD_LESSCHARSET</code></span><a class="headerlink" title="Permalink to this term" href="timedatectl.html#%24SYSTEMD_LESSCHARSET">¶</a></dt><dd><p>用于覆盖默认传递给 <span class="command"><strong>less</strong></span> 程序的字符集。
      (如果终端兼容 UTF-8 ，那么默认值是 "<code class="literal">utf-8</code>" )</p></dd></dl></div></div><div class="refsect1"><a name="id-1.10"></a><h2 id="例子">例子<a class="headerlink" title="Permalink to this headline" href="timedatectl.html#%E4%BE%8B%E5%AD%90">¶</a></h2><p>显示当前的时间设置
    </p><pre class="programlisting">$ timedatectl
               Local time: Thu 2017-09-21 16:08:56 CEST
           Universal time: Thu 2017-09-21 14:08:56 UTC
                 RTC time: Thu 2017-09-21 14:08:56
                Time zone: Europe/Warsaw (CEST, +0200)
System clock synchronized: yes
              NTP service: active
          RTC in local TZ: no</pre><p>
    </p><p>开启网络时间同步服务
    </p><pre class="programlisting">$ timedatectl set-ntp true
==== AUTHENTICATING FOR org.freedesktop.timedate1.set-ntp ===
Authentication is required to control whether network time synchronization shall be enabled.
Authenticating as: user
Password: ********
==== AUTHENTICATION COMPLETE ===</pre><p>

    </p><pre class="programlisting">$ systemctl status systemd-timesyncd.service
● systemd-timesyncd.service - Network Time Synchronization
   Loaded: loaded (/usr/lib/systemd/system/systemd-timesyncd.service; enabled)
   Active: active (running) since Mo 2015-03-30 14:20:38 CEST; 5s ago
     Docs: man:systemd-timesyncd.service(8)
 Main PID: 595 (systemd-timesyn)
   Status: "Using Time Server 216.239.38.15:123 (time4.google.com)."
   CGroup: /system.slice/systemd-timesyncd.service
           └─595 /usr/lib/systemd/systemd-timesyncd
…</pre><p>
    </p><p>显示
    <a href="systemd-timesyncd.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-timesyncd.service</span>(8)</span></a> 的当前状态
    </p><pre class="programlisting">$ timedatectl timesync-status
       Server: 216.239.38.15 (time4.google.com)
Poll interval: 1min 4s (min: 32s; max 34min 8s)
         Leap: normal
      Version: 4
      Stratum: 1
    Reference: GPS
    Precision: 1us (-20)
Root distance: 335us (max: 5s)
       Offset: +316us
        Delay: 349us
       Jitter: 0
 Packet count: 1
    Frequency: -8.802ppm</pre><p>
    </p></div><div class="refsect1"><a name="id-1.11"></a><h2 id="参见">参见<a class="headerlink" title="Permalink to this headline" href="timedatectl.html#%E5%8F%82%E8%A7%81">¶</a></h2><p>
      <a href="systemd.html#"><span class="citerefentry"><span class="refentrytitle">systemd</span>(1)</span></a>,
      <a href="http://man7.org/linux/man-pages/man8/hwclock.8.html"><span class="citerefentry"><span class="refentrytitle">hwclock</span>(8)</span></a>,
      <a href="http://man7.org/linux/man-pages/man1/date.1.html"><span class="citerefentry"><span class="refentrytitle">date</span>(1)</span></a>,
      <a href="localtime.html#"><span class="citerefentry"><span class="refentrytitle">localtime</span>(5)</span></a>,
      <a href="systemctl.html#"><span class="citerefentry"><span class="refentrytitle">systemctl</span>(1)</span></a>,
      <a href="systemd-timedated.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-timedated.service</span>(8)</span></a>,
      <a href="systemd-timesyncd.service.html#"><span class="citerefentry"><span class="refentrytitle">systemd-timesyncd.service</span>(8)</span></a>,
      <a href="systemd-firstboot.html#"><span class="citerefentry"><span class="refentrytitle">systemd-firstboot</span>(1)</span></a>
    </p></div></div></body></html>
